Skip to content

Change ticket & conversation assignee ID fields to integer type (Preview)#459

Merged
VarshSuresh merged 2 commits intomainfrom
VarshSuresh/ticket-assignee-id-integer-preview
Apr 22, 2026
Merged

Change ticket & conversation assignee ID fields to integer type (Preview)#459
VarshSuresh merged 2 commits intomainfrom
VarshSuresh/ticket-assignee-id-integer-preview

Conversation

@VarshSuresh
Copy link
Copy Markdown
Contributor

@VarshSuresh VarshSuresh commented Apr 17, 2026

Why?

Towards

The Ticket API response returns admin_assignee_id and team_assignee_id as strings, while the Conversation API returns them as integers. This inconsistency causes confusion for API consumers working with both resource types. The backend change (intercom/intercom#497865) converts these fields to integers in the unstable/Preview version, and these docs need to reflect that.

How?

Updates the Preview OpenAPI spec to change the ticket response schema types from string to integer, updates all response examples to use bare integers, and adds a breaking change changelog entry.

Docs PR

Generated with Claude Code

@VarshSuresh VarshSuresh self-assigned this Apr 17, 2026
Convert admin_assignee_id and team_assignee_id from string to integer
in the Preview API spec to align the Ticket API with the Conversation API,
which already returns these fields as integers.

Mirrors intercom/developer-docs#849 (backend: intercom/intercom#497865).

Affected endpoints: POST /tickets, PUT /tickets/{id}, POST /tickets/search.
Stable versions (2.7–2.15) are not affected.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@VarshSuresh VarshSuresh force-pushed the VarshSuresh/ticket-assignee-id-integer-preview branch from 2489777 to 524ca28 Compare April 22, 2026 14:45
@VarshSuresh VarshSuresh changed the title Change ticket assignee ID fields to integer type (Preview) Change ticket & conversation assignee ID fields to integer type (Preview) Apr 22, 2026
@VarshSuresh VarshSuresh marked this pull request as ready for review April 22, 2026 14:46
…n Preview spec

Conversation schemas: remove nullable from admin_assignee_id and team_assignee_id,
return 0 instead of null when unassigned. Ticket schema: add return-0-when-unassigned
language to descriptions. Aligns with developer-docs PR #849.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@VarshSuresh VarshSuresh requested a review from a team April 22, 2026 15:06
@VarshSuresh VarshSuresh merged commit b12eb71 into main Apr 22, 2026
3 checks passed
@VarshSuresh VarshSuresh deleted the VarshSuresh/ticket-assignee-id-integer-preview branch April 22, 2026 15:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants